This is the documentation for QTrash™, an INIT that deletes empty folders. This document was prepared using TeachText 7.0 so as to make it readily available to all users. If you distribute a non- TeachText copy of this documentation, please include this copy as well. Thanks!
WHAT DOES QTRASH™ DO?
QTrash™ will delete all empty folders from the startup volume. Some folders are exceptions to this. They are:
• Apple Menu Items
• Control Panels
• Control Panels (disabled)
• Desktop Folder
• Extensions
• Extensions (disabled)
• Preferences
• PrintMonitor Documents
• Spool Folder
• Startup Items
• System Extensions
• System Extensions (disabled)
• Temporary Items
• Trash
If you wish to extend this list on your own, use ResEdit (or other resource editor) to edit the STR# resource. If you are ordering a copy of QTrash™ on diskette, I’ll be more than happy to add to the list for you.
WHAT DO I NEED TO USE QTRASH™?
Good question (bad answer). At this time, I have personally tested QTrash™ in the following environments:
• Mac SE running System 7.0.
• Mac SE with Radius™ 16MHz accellerator running System 6.0.7
• Mac II running System 6.0.7 (no, I don’t have color icons yet)
It has also been tested on the following (thanks, Scott!):
• Mac 512KE w/NewLife™ 1 upgrade board running System 7.0
• Mac Plus running System 6.0.7
• Mac II running System 7.0
• Mac IIcx running System 6.0.5 (hey Wayne, upgrade!)
I hope to be able to test it on a Mac SE with the NewLife™ 16 (or the TransWarp™ SE). As people try it out on other Macs and with other Systems and let me know what works and what doesn’t, I’ll update the documentation.
BTW, I seem to recall a warning in Inside Macintosh Volume IV about hierarchical directory routines. QTrash™ uses the low-level function PBGetCatInfo. If you’ve got 64K ROMs and aren’t using HFS by now, I’m sorry — you probably can’t use QTrash™.
WHY USE QTRASH™ IN THE FIRST PLACE?
Personally, I’m rather picky about the layout of files and folders on the volumes I manage at work. I am constantly finding folders such as “Empty Folder”, “Copy of Empty Folder”, “Copy of Copy of Empty Folder”, etc. — all with no files. One would think that “users” would have better things to do with their time. Oh, well...
This is why I wrote QTrash™. That and I’ve finally managed to find sufficient time to learn C on the Macintosh (I’m learning C and Macintosh programming at the same time, so it’s slow going).
BTW, beginning with version 1.0ß2, it now includes ShowINIT code; I managed to locate public domain source. I’ve also included a ‘cicn’ resource.
WHAT’S THIS SHAREWARE STUFF ABOUT?
People like me occasionally come up with what we think are “neat ideas”, and then do something about them. When we’ve done the best we think we can, we upload them to information services, hoping that others will also find them useful. Although we have no means of forcing people to pay for our work, we trust that most people are basically honest and will register their copy if they find it useful. Normally, the ShareWare fee isn’t much; it’s more of an incentive to the author to improve on existing programs and to think up new ones as well. I have a few other ideas floating about in my head, but for right now, I’ll see what happens with this one.
If you don’t find QTrash™ useful, that’s OK. I didn’t intend for this to be the next most-requested downloadable. Please destroy, or better yet, give your copy to someone else that might. Thanks for taking the time to look it over. Perhaps you’ll drop me a note as to what you didn’t like.
If you are one of those people who find QTrash™ useful, great! I hope it will help take a little more stress out of your life as well.
If you are also one of those people that registers their ShareWare, even better! The ShareWare fee for QTrash™ is U.S. $5.00, or $10.00 if you’d like a copy on diskette. If you want the diskette, please specify whether you’d prefer 400K, 800K, or 1.4MB. Yes, it’s only a 4K file (and this document isn’t that large either, although it is larger than the INIT!), but you are in effect paying for the diskette as well, so you might as well get one you can make good use of. However, I don’t want to send you a diskette you can’t read, either, so diskettes will be formatted as 400K unless otherwise specified. Also, if you want the diskette, let me know if you would like any additional folders added to the exclusion list. Modifying the STR# resource is easy.
Please make checks or money orders payable to:
Jon L. Grushka II
PO Box 214
Addison, IL 60101-0214
I can also be reached on the following information services.
CompuServe @ 72377,2004
GEnie @ J.GrushkaII1
SHAREWARE LICENSE AGREEMENT:
Yes, this should be fairly serious, but ShareWare should be fun too.
1. GRANT OF LICENSE. Payment of the ShareWare fee for QTrash™ (the “SOFTWARE”) grants to you the right to use the SOFTWARE on as many CPUs as you have at one site. You may network the SOFTWARE or otherwise use it on more than one computer or computer terminal at the same time, provided you do not allow access to the SOFTWARE from off-site computers, terminals, or networks. This does not include information services (see INFORMATION SERVICES below). Basically, I’m not going to ask for $5 per Mac — that would be silly. However, it isn’t fair to me if an organization has a nation-wide network and only pays for a single copy. So let’s keep things reasonable, okay? BTW, “unlimited” licenses can be had...
2. COPYRIGHT. The SOFTWARE belongs to Jon L. Grushka II (that’s me) and I retain all rights to the SOFTWARE at all times. This includes the source code, object code, icon, and name. Basically, I wrote it, so it’s MINE. This excludes portions of this code derived from the THINK C libraries, which belong to Symantec. They do nice work!
3. DISTRIBUTION. You may NOT rent or lease the SOFTWARE, nor distribute the SOFTWARE for ANY fee (reasonable or otherwise). This includes distribution sources such as EduCorp. You may give away the SOFTWARE to any of your friends or associates, as long as you include the documentation (this file). If I find QTrash™ being distributed in any unapproved manner or form or by anyone not authorized to do so, I will not be happy.
4. INFORMATION SERVICES. The SOFTWARE is NOT, I repeat, NOT to be uploaded, transferred, or otherwise made available to information services without the express WRITTEN permission of the author (Jon L. Grushka II). I have friends on other networks (and they told two friends, and so on,...) that will let me know if they find it. I won’t be happy if they do. If you are a SYSOP or other BBS or information service manager, please contact me by mail, on CompuServe, or on GEnie if you wish to make QTrash™ available to your users. BTW, I check GE-Mail most often (almost as often as CT-Mail, but that’s another story...).
EXCEPTION 1: Any information service that I personally upload these files to has my permission to evaluate these files themselves, and post them (or not) in their software library(s).
EXCEPTION 2: This gives Scott D. King the authority to upload QTrash™ to America Online and BBS’s; the appropriate SysOps of course still retain the right to accept or reject it.
5. TIME AND OTHER LIMITATIONS. In general, I don’t believe in time-locked software. There are enough people out there already that don’t care what day their Mac thinks it is. Of course, how many time-locks have low AND high limits... Anyway, here’s the deal. Try QTrash™ for 15 days. If you like it and continue to use it, please register your copy. If not, please destroy or give away your copy. BTW, unregistered copies are unsupported copies.
6. NO PROMISES, NO WARRANTIES, NO GUARANTEES, NO LIABILITY FOR CONSEQUENTIAL DAMAGES, NO FRUIT CUP! The user assumes all liability and responsibility for using the SOFTWARE. You should always follow good backup and anti-virus procedures. I’ve checked out QTrash™ with Disinfectant™ myself, and detected no viruses as of the time this file was distributed. My original source, project, and resource files are kept on a locked floppy away from my Mac (and magnetic fields, heat, humidity, direct sunlight, and cat hair).
Any similarities between QTrash™ and any other folder-deleting utility, fictitious or non-fictitious, past, present or future, alive or dead, is purely coincidental. So there. : )
